home *** CD-ROM | disk | FTP | other *** search
/ Hand Picked Software / Hand Picked Software.iso / technicl / modemdoc / mdr5doc.exe / MDR5FST.TXT < prev   
Text File  |  1993-04-25  |  40KB  |  991 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.               __________________________________________________
  8.                                     T H E 
  9.                                   M O D E M
  10.                                  D O C T O R
  11.                              Version 5.0S / 5.0R
  12.                   Hank Volpe copyr. 1989,1990,1991,1992,1993
  13.                                 P.O. Box 43214
  14.                               Baltimore MD 21236      
  15.                __________________________________________________
  16.  
  17.  
  18.  
  19. Thank you for using the Modem Doctor. This file offers you a brief
  20. introduction into how the program works, and how you can use the Modem
  21. Doctor to solve your communication problems. 
  22.  
  23. Why would you need the Modem Doctor? Well, have you ever tried to install
  24. a serial card or a modem to find out that you have the IRQ lines set
  25. wrong, or the modem cable wired wrong, or some silly jumper set
  26. incorrectly? What about when you have had trouble connecting to a BBS? Is
  27. it the phone line, your setup, or your modem? Could it be the uart,
  28. settings on your serial card, or an incorrect assignment of the base port
  29. address? The Modem Doctor was written to assist you with all of these
  30. problems and some of the pitfalls involved in Personal Computer
  31. communications. 
  32.  
  33. The Modem Doctor checks every serial port chip (uart) register, checks
  34. cables and modems for proper handshaking signals, and will inform you if
  35. it runs across something that isn't set properly. Modems are also
  36. rigorously tested, including handshaking tests and modem self-connect
  37. tests which simulate an on-line connection. IRQ assignment errors, base
  38. port addressing errors, and a host of other settings are checked. The
  39. Modem Doctor also will inform you of the type of uart and modem you have
  40. installed, and will print a copy of the test results to a printer or a
  41. file.
  42.  
  43. I feel the Modem Doctor is very easy to use, in fact all you need to do is
  44. move the cursor around with your arrow keys and press return to run a
  45. feature or press the escape key to get out. You can get help at any time
  46. by pressing ALT-H. You can change the baud rate of the port you are
  47. working with at any time by pressing ALT-B. ALT-F is used to by-pass the
  48. microprocessor tests (which is discussed more in the technical reference
  49. manual). These special keys are called "Hot-Keys", and can be short-cuts
  50. at times during testing.
  51.  
  52. Remember a left or a right arrow is used to move around the main menu.
  53. Pressing enter will activate a pulldown window. Use the up or down arrows
  54. to make a selection. Press enter to start a test or escape to abort. Use
  55. any of the "hot-keys" at any time you wish. It's that simple!
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.        Modem Doctor Ver 5.0 copyright (c) 1987-1993 Hank Volpe    Users Manual                                        Page 2
  74.  
  75.  
  76. Starting Modem Doctor
  77. ---------------------
  78.  
  79. Here is a list of all the Modem Doctor files. Make sure you are logged
  80. onto the disk drive that has all of these files. Hard disk users should be
  81. logged into a directory that contains these files;
  82.  
  83. MDR.EXE       The Modem Doctor program executable file.
  84. MDR.CFG       A file that contains your custom color selections 
  85.                (optional, created by the user).
  86.  
  87. MDR5.DRV      A reserved file name for future external modem drivers.
  88.                (there are currently no files with this name).
  89.  
  90. MDR.DAT       A file that contains user created setup instructions for
  91.                running MDR in the /S mode (this will be explained later).
  92.  
  93. MDR.MNU       A mouse driver file that can be loaded with any Microsoft-
  94.                compatible menu load program (such as menu.com).
  95.  
  96. The program MDR.EXE can be run out of a dos path command without you being
  97. logged into the proper directory or disk, however the user selected
  98. configuration (MDR.CFG) and external driver files will not be used.
  99.  
  100. Also included with the Modem Doctor are the following text files that are
  101. a good source of technical information about testing, and the history of
  102. the Modem Doctor program. Included is an order form, for the Modem Doctor
  103. is distributed in two versions. The shareware version (5.0S) allows you to
  104. take a look at the Modem Doctor before you buy it. The Registered Version
  105. (5.0R) includes more features, comm port selections, higher baud rates and
  106. some extra test information. I feel quite certain you will agree that the
  107. Registered Version is worth the price of $19.95 (which includes shipping
  108. in the U.S.). Here is a list of these support files;
  109.  
  110.  
  111. MDR5DOC.TXT   The Technical reference Manual that explains in detail the
  112.               operation and testing of your modem and uart. 
  113.  
  114. MDR5FST.TXT   This file.
  115. MDR5ORDR.TXT  The form for you to use to order the registered version of 
  116.               the Modem Doctor.
  117.  
  118. There are four modes that the Modem Doctor operates in; normal, bios
  119. writes, setup (/s) and exchange (/x).
  120.  
  121. Normal mode is simply starting the Modem Doctor from the dos prompt by
  122. typing; MDR. 
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.        Modem Doctor Ver 5.0 copyright (c) 1987-1993 Hank Volpe    Users Manual                                        Page 3
  140.  
  141.  
  142. Bios write mode is a feature that you might use if you have a totally
  143. incompatible display adapter. If you are visually impaired, this feature
  144. allows the text of the Modem Doctor to be echoed to your speech
  145. synthesizer system. Bios writes use the ROM-Bios of your computer instead 
  146. of working to the display adapter. This method is very slow compared to
  147. screen writes, so if you have no need for it, I would suggest that you
  148. refrain from using it. Starting the Modem Doctor in this bios write mode
  149. is done from the dos prompt by typing ; MDR /b
  150.  
  151. Setup mode is a very useful feature and gives you the ability to use the
  152. Modem Doctor every day. Setup mode is used to send setup strings
  153. (initialization strings) to your modem. In this mode, the Modem Doctor
  154. looks for a file called MDR.DAT, which you make with a simple ASCII text
  155. editor. This file contains the port, the baud rate, and the setup string
  156. you want to send to the modem. If the modem received this information
  157. properly, a message is printed to the screen, and an errorlevel of 0 is
  158. returned. If there is a problem, a message is printed and an errorlevel of
  159. 99 is returned. You can use this feature inside batch files, and these
  160. errorlevels can be used to trigger different actions. This mode is
  161. explained in great detail, with example batch files and MDR.DAT files.
  162. Starting the Modem Doctor in this setup mode is done from the dos prompt
  163. by typing ; MDR /s
  164. (Note, the setup mode is a registered feature).
  165.  
  166. New in Version 5.0, you can instruct Modem Doctor to use a comm driver 
  167. instead of its normal, uart control functions. This allows you to test the 
  168. operation of FOSSIL or other INT 14 drivers. A warning though, most comm 
  169. drivers do not allow Modem Doctor complete diagnostic testing ability. Always 
  170. make sure your modem is operating properly with Modem Doctor before you use 
  171. the FOSSIL feature. To start Modem Doctor in this mode, type MDR /i (for INT 
  172. 14 generic interface) or MDR /F (for FOSSIL support). Modem Doctor works with 
  173. both standard and extended version FOSSILS.
  174.  
  175. Finally, the exchange mode is used to swap Comm pointers in memory. This
  176. makes Com1 act like Com2. The main reason for this feature is so you can
  177. access a serial device that is not interrupt driven (like a printer) from
  178. some high level languages that do not allow access to Com2. Some programs
  179. do not work with two Comm ports. Running the program does not permanently
  180. alter anything, all changes can be restored by running the Modem Doctor in
  181. exchange mode again, or by warmbooting your computer. Starting the Modem
  182. Doctor in this exchange mode is done from the dos prompt 
  183. by typing; MDR /x. 
  184.  
  185. You can use MDR /x to swap any of the 4 Dos comm port pointers besides the 
  186. defaults of Com1 and Com2. To do this just type the numbers of the two ports 
  187. you wish to switch..ie  MDR /x 1 4  will swap Com1 and Com4. MDR /x 2 3 will 
  188. swap Com2 and Com3. 
  189.  
  190. The following pages show you operating instructions that you receive when
  191. the Modem Doctor runs in the normal or bios write modes.
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.        Modem Doctor Ver 5.0 copyright (c) 1987-1993 Hank Volpe    Users Manual                                        Page 4
  206.  
  207. After the Modem Doctor starts, you are presented with the following
  208. screen;
  209.  
  210. ┌───────────────────────────── The Modem Doctor─────────────────────────────┐
  211. │                         Welcome to the Modem Doctor                       │
  212. └───────────────────────────────────────────────────────────────────────────┘
  213.     ╒[ Modem / Uart Hardware Detection]══════════════════════════════════╕
  214.     │ Port assignments  Base(hex)    Irq       Special Port Usage        │
  215.     │ Com port 1   [ ]     3f8        4                                  │
  216.     │ Com port 2   [ ]     2f8        3    IRQ assigned to a mouse driver│
  217.     │ Com port 3   [ ]  not found                                        │
  218.     │ Com port 4   [ ]  not found                                        │
  219.     │ Com port 5   [ ]                                                   │
  220.     │ Com port 6   [ ]                                                   │
  221.     │ Com port 7   [ ]                                                   │
  222.     │ Com port 8   [ ]                                                   │
  223.     └────────────────────────────────────────────────────────────────────┘
  224.  
  225.  ╔[  Serial Port Detection ]═══════════════════════════════════════════════╗
  226.  ║                          Serial port detection                          ║
  227.  ║                Searching for other standard active Comm ports           ║
  228.  ║                                                                         ║
  229.  ║                              Total Comm ports  =2                       ║
  230.  ║                        PRESS ANY KEY TO START TESTING                   ║
  231.  ║                                                                         ║
  232.  ║                                                                         ║
  233.  ║                                                                         ║
  234.  ══════════════════════════════════════════════════════════════════════════╝ 
  235.  
  236.  
  237.  
  238. When you start Modem Doctor for the first time, two windows are displayed on 
  239. screen. The first window, (Modem/Uart Hardware detection) gives you a 
  240. snapshot of your computer/serial port hardware. In the example above, it 
  241. found 2 Comm ports (or serial ports). The registered version also looks for 
  242. custom Comm ports (those defined by a user in a section called Log-in). 
  243.  
  244. New in version 5.0, Modem Doctor will also attempt to verify which IRQ line 
  245. your comm port is using. Modem Doctor traps IRQ's 2,3,4,5,7 and then creates 
  246. a situation that should cause an interrupt. When the interrupt happens, Modem 
  247. Doctor notes the IRQ line, and displays it under the IRQ heading. If no 
  248. interrupt occurs, a 0 is displayed, which means you may have an IRQ problem, 
  249. or you need to use a FOSSIL driver for support. (See the tech reference 
  250. manual under FOSSILS and TIMER routines).
  251.  
  252. Also new in version 5.0, if a serial port is being used by a mouse driver, 
  253. Modem Doctor will flag this usage. This is done by requesting this info from 
  254. the mouse driver. Note, this feature only works with Microsoft compatible 
  255. mouse drivers.
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.        Modem Doctor Ver 5.0 copyright (c) 1987-1993 Hank Volpe    Users Manual                                        Page 5
  272.  
  273.  
  274. Meanwhile, the Serial Port Detection window displays what Modem Doctor is 
  275. doing. This window maintains a dialogue between you and the program, and if 
  276. problems or special instructions need to be displayed, they are shown in this 
  277. window.
  278.  
  279. Finally, at the bottom of the screen, the copyright notice is displayed 
  280. along with either "shareware version" or your personal serial number. As a 
  281. registered user, you need your serial number for support and for 
  282. updates.After you press return, you will get the following windows on your 
  283. screen;
  284.  
  285. At this point, pressing any key will bring up a series of windows, whose 
  286. function is explained below;
  287.  
  288.  ╔[  Ports  ]═╗   ╔[  IRQ's  ]═╗    ╔[  Baud  ]══╗  
  289.  ║ Use COM 1  ║   ║ Use IRQ 2  ║    ║   300 BPS  ║  
  290.  ║ Use COM 2  ║   ║ Use IRQ 3  ║    ║  1200 BPS  ║  
  291.  ╚════════════╝   ║ Use IRQ 4  ║    ║  2400 BPS  ║  
  292.                   ║ Use IRQ 5  ║    ║  4800 BPS  ║ * 
  293.                   ║ Use IRQ 7  ║    ║  9600 BPS  ║ * 
  294.                   ╚════════════╝    ║ 19200 BPS  ║ * 
  295.                                     ║ 38400 BPS  ║ * Registered Versions
  296.                                     ║ 57600 BPS  ║ * only
  297.                                     ╚════════════╝  
  298.  
  299.  
  300. The Ports window will only display valid comm ports that you can work with. 
  301. The IRQ window automatically selects what it believes is the correct IRQ 
  302. (based on its tests), however you are free to select any IRQ line you wish. 
  303. Note- selecting the wrong IRQ is a great way to get all kinds of useless 
  304. error messages, so unless you think Modem Doctor made a mistake, use the 
  305. choice that Modem Doctor has made for you. Finally, you can pick a baud rate. 
  306. Although any computer, even an old XT will work at the highest rates, you 
  307. should realize that only fast machines can really use faster speeds. Make 
  308. sure you read the sections in the Technical Reference Manuals regarding 
  309. HISPEED modems and Interrupt Latency testing.Use the up or down arrow keys to 
  310. move the highlighted bar to your selection. If you are using a mouse, and if 
  311. you have the custom Modem Doctor mouse driver loaded, , moving the mouse up 
  312. or down on your pad will do the same thing. Press return or the left mouse 
  313. key to complete your selection.
  314.  
  315. Please take care when selecting a baud rate, for you should not select 
  316. a speed faster than the modem you wish to test can support. If you are just
  317. testing the serial port without a modem, you can set the speed anywhere. In
  318. the example above, say we decided to use port 2 and use 2400 bps as the
  319. speed. 
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.        Modem Doctor Ver 5.0 copyright (c) 1987-1993 Hank Volpe    Users Manual                                        Page 6
  338.  
  339.  
  340. After selecting the speed, you will get the next window;
  341.  
  342.                     ╒[  Select an Option  ]═══════════════╕
  343.                     │ Test Modem / Port 2 to 2400 BPS     │
  344.                     │ Test the Uart Hardware Only         │
  345.                     │ Don't set up modem, return to Menu  │
  346.                     └─────────────────────────────────────┘
  347.  
  348. Testing the Modem and the Port starts a series of tests which communicate
  349. to the comm port, talk to the microprocessor in the modem, run a few tests
  350. of the modem in what is called the "command mode" and then it displays of
  351. all Uart status and control and the first 16 Modem S-registers.
  352.  
  353. If you decide to test the uart only, then only the comm port section of the
  354. tests are run. You should use this test if you are just testing the comm
  355. port, or if you want to determine if the problem you are having is with the
  356. modem or the comm port.
  357.  
  358. The last option gives you the ability to change your mind in case you made
  359. an error in any of the port or baud rate choices, or simply hit the escape
  360. key to get out of this testing.
  361.  
  362. The Modem Doctor requires that you have logged in at least 1 comm port so
  363. that it can execute tests. So, if this is your first time through and you
  364. did not select, you will be "beeped" and warned to setup a port in order to
  365. access any of the other tests with the exception of auto-login and manual
  366. log-in (for registered users). If you have selected at least 1 comm port,
  367. then if you escape, the last settings you used will still be in force.
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.        Modem Doctor Ver 5.0 copyright (c) 1987-1993 Hank Volpe    Users Manual                                        Page 7
  404.  
  405.  
  406. Assuming you made a selection to start testing, the Modem Doctor now begins
  407. testing. If you selected to test the modem and the port, you will get the
  408. following displayed to you in most instances;
  409.  
  410.     ╒[ Modem / Uart System Diagnostics]══════════════════════════════════╕
  411.     │ Comm port /IRQ in use [ ] Port = 1  Address = 3F8  IRQ = 4         │
  412.     │ Int 14 interface      [ ] Inactive                                 │
  413.     │ Uart type             [ ] 16450/8250A detected                     │
  414.     │ Baud rate selected    [ ]  2400                                    │
  415.     │ Baud Rate reg test    [ ] Confirmed correct baud rate              │
  416.     │ Modem Microprocessor  [ ] Modem Microprocessor On-Line             │
  417.     │ Modem ID Type         [ ] 9600+ bps modem                          │
  418.     │ Modem Memory/Rom      [ ] Memory tests OK                          │
  419.     └────────────────────────────────────────────────────────────────────┘
  420.  
  421. ╒[ Diagnostic Dialog]═══════════════════════════════════════════════════════╕
  422. │                  Preliminary diagnostic checks of hardware                │
  423. │                  -----------------------------------------                │
  424. │                   Confirmed uart setup to proper baud rate                │
  425. │                          Testing Modem Microprocessor                     │
  426. │                          --------------------------                       │
  427. │                                                                           │
  428. │                   Modem microprocessor command bus active                 │
  429. │                Modem ID reports a 2400 bps modem installed                │
  430. │                    Modem microprocessor memory tests OK                   │
  431. │                Modem microprocessor accepts setup commands                │
  432. │                     Modem - Uart status appears correct                   │
  433. │              Press any key to see register status and diagnosis           │
  434. │                                                                           │
  435. └───────────────────────────────────────────────────────────────────────────┘
  436.  
  437.  
  438. What did the Modem Doctor do? Well, first, the Modem Doctor looked for the
  439. type of uart so that it could figure out what tests to run. It next checked
  440. a very important register in the uart that holds the baud rate divisor. It
  441. programmed it for a certain speed and then made sure that speed was indeed
  442. held properly in the uart register. These same tests are run if you had
  443. decided only to run the uart tests and not the modem tests (or visa versa).
  444.  
  445. Next, the Modem Doctor established communications with the modem
  446. microprocessor. There are dozens of ways in which this could happen, but
  447. for starters, it figures you are using an "AT" compatible instruction set.
  448. There are ways to test modems of any kind with the Modem Doctor. This
  449. information is available in the technical reference manual that comes with
  450. the Modem Doctor, so for now just assume this is a standard PC-type modem.
  451. When the Modem Doctor makes contact, it tells you that the modem is in the
  452. command mode. it then asks the modem for its ID number. Theoretically, this
  453. should indicate the maximum speed your modem can work at, however, there
  454. are some manufacturers that do not follow this convention, so don't be
  455. alarmed if you have a 9600 bps modem and it says you have a 2400 bps
  456. installed, for the Modem Doctor is only working with information provided
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.        Modem Doctor Ver 5.0 copyright (c) 1987-1993 Hank Volpe    Users Manual                                        Page 8
  470.  
  471. by the manufacturer and stored in its ROM. Next, a quick test of the RAM
  472. and ROM memory is run. Some modems do both, others only do one or the
  473. other. Finally, a setup string is sent to the modem, which should respond
  474. back properly. If you decided to run the uart tests alone, then none of
  475. these modem tests are run.
  476.  
  477. Finally, the screen is filled with displays that show you the internal
  478. settings of the Uart registers and the first 16 S-registers. Many modems
  479. have more than 16 S-registers, however these first 16 are the only
  480. universally agreed-upon registers. If a problem turns up, you will get a
  481. diagnostic message that points out the error gives you an idea of what the
  482. problem can be.
  483.  
  484. A normal Uart test sequence looks like this;
  485.  
  486. ╒[ Line Control Register ]══════════╕
  487. │  DLB STB STP EPS PEN STB WS1 WS0  │ * These will alternate color. Dark
  488. └───────────────────────────────────┘   for a logic low, Bright for a
  489. ╒[ Line Status Register ]═══════════╕   logic high. If all is ok
  490. │      TSE THE BI  FE  PE  OE  DR   │   you get the diagnostic window
  491. └───────────────────────────────────┘   message displayed below.
  492. ╒[ Modem Control Register ]═════════╕
  493. │              LP  OT2 OT1 RTS DTR  │
  494. └───────────────────────────────────┘ ╒[ Diagnostics ]══════════╕
  495. ╒[ Modem Status Register ]══════════╕ │    Hardware tests OK    │
  496. │  RLS RI  DSR CTS DRD TER DDR DCS  │ │Press any key to continue│
  497. └───────────────────────────────────┘ │                         │
  498. ╒[ Interrupt ID Register ]══════════╕ └─────────────────────────┘
  499. │                      ID1 ID0 ITP  │
  500. └───────────────────────────────────┘
  501. ╒[ Interrupt Enable Register ]══════╕
  502. │                  ESI ELI ETI ERI  │
  503. └───────────────────────────────────┘
  504. ╒[ Interrupt Mask Register ]════════╕
  505. │  IQ7 IQ6 IQ5 IQ4 IQ3 IQ2 IQ1 IQ0  │
  506. └───────────────────────────────────┘
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.        Modem Doctor Ver 5.0 copyright (c) 1987-1993 Hank Volpe    Users Manual                                        Page 9
  536.  
  537.  
  538. If however something is wrong, you will get this display;
  539.  
  540.  
  541. ╒[ Line Control Register ]══════════╕
  542. │  DLB STB STP EPS PEN STB WS1 WS0  │* The register name is displayed as
  543. └───────────────────────────────────┘  the first item and what was wrong.
  544. ╒[ Line Status Register ]═══════════╕
  545. │      TSE THE BI  FE  PE  OE  DR   │╒[ Diagnostics]═══════════════════════╕
  546. └───────────────────────────────────┘│ Line Control Register readings show │
  547. ╒[ Modem Control Register ]═════════╕│ that the word length selected is    │
  548. │              LP  OT2 OT1 RTS DTR  ││ incorrect or you have a parity error│
  549. └───────────────────────────────────┘│ error. WS1 and WS0 should both be   │
  550. ╒[ Modem Status Register ]══════════╕│ on indicating that 8 bit words are  │
  551. │  RLS RI  DSR CTS DRD TER DDR DCS  ││ to be used. All other readings      │
  552. └───────────────────────────────────┘│ should be low. Parity errors could  │
  553. ╒[ Interrupt ID Register ]══════════╕│ happen once but not every time. If  │
  554. │                      ID1 ID0 ITP  ││ either persists, then the Uart is   │
  555. └───────────────────────────────────┘│ defective or communications to the  │
  556. ╒[ Interrupt Enable Register ]══════╕│ Uart are suspect.                   │
  557. │                  ESI ELI ETI ERI  ││                                     │
  558. └───────────────────────────────────┘│   PRESS ANY KEY TO CONTINUE         │
  559. ╒[ Interrupt Mask Register ]════════╕│                                     │
  560. │  IQ7 IQ6 IQ5 IQ4 IQ3 IQ2 IQ1 IQ0  ││                                     │
  561. └───────────────────────────────────┘└─────────────────────────────────────┘
  562.  
  563. There are many diagnostic messages you could get, and all of these are
  564. detailed in the technical reference manual. If you are running the modem
  565. test, you will get this display plus the first 16 S-registers, however if
  566. there was an error detected, you will get the example listed above and no
  567. S-register display. The reason for this is simple, because the uart might
  568. have a problem there is no way to know if the data coming from the modem is
  569. totally correct.
  570.  
  571. After you have logged in at least 1 comm port, the Modem Doctor will enter
  572. the main menu section. Use the main menu bar by operating your left and
  573. right arrow keys. Complete a selection with the enter key, or escape with
  574. the escape key.
  575.  
  576. The menu system is very straight forward, so you will only see here a list
  577. of all the possible menus you might run into. For detailed explanations on
  578. the tests that are conducted, refer to the Modem Doctor technical reference
  579. file (MDR5DOC.TXT).
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.        Modem Doctor Ver 5.0 copyright (c) 1987-1993 Hank Volpe    Users Manual                                       Page 10
  602.  
  603.  
  604. Main Menu Bar:
  605.  
  606. ┌───────────────────────────── The Modem Doctor────────────────────────────┐
  607. │Log-in   Regs      Carrier   Loopback  Options   Setup     End Program    │
  608. └──────────────────────────────────────────────────────────────────────────┘
  609.  
  610. For example, if you wanted to display the registers again, chose the Regs
  611. selection and press return. Next you will get a pulldown of various
  612. register tests. Just use the down or up arrows to slide the bar to the
  613. selection you wish to make, and press return to activate it.
  614.  
  615. Pulldowns
  616. ------------
  617. Pulldowns are easy to use. Each pulldown system follows the same ground
  618. rules; First, you can escape any pulldown by pressing Escape, or skip to
  619. the next pulldown by using the left or right arrow keys. Second, each
  620. pulldown includes a detailed help menu that you can access by moving the
  621. sliding bar to help or by pressing the hot-key combination ALT-H. Press any
  622. key to escape help and return to your selection. As you move from pulldown
  623. to pulldown, the Modem Doctor will remember your last selection and move
  624. the sliding bar to that choice for you.
  625.  
  626. Detailed Menus and what each  does for you;
  627.  
  628.    * Select these from the Login menu
  629. ┌───────────────────────────── The Modem Doctor───────────────────────────┐
  630. │Log-in   Regs      Carrier   Loopback  Options   Setup     End Program   │  
  631. └─────────────────────────────────────────────────────────────────────────┘
  632. ╔[  Comm Port Login  ]═══════════╗
  633. ║ Let me Auto Detect COMM Ports  ║ <- Searches for all Comm ports
  634. ║ You Manually Enter COMM Ports  ║+<- You enter port addresses
  635. ║ Help with Auto login Commands  ║ <- Detailed help or ALT-H
  636. ║      Return To Main Menu       ║
  637. ╚════════════════════════════════╝    + registered version only
  638.  
  639.  
  640.            * Select these from Regs menu
  641. ┌───────────────────────────── The Modem Doctor────────────────────────────┐
  642. │Log-in   Regs      Carrier   Loopback  Options   Setup     End Program    │
  643. └──────────────────────────────────────────────────────────────────────────┘
  644.          ╔[  Register Tests  ]══════════════╗
  645.          ║ Quick Uart Register Diagnostics  ║ <- Displays all registers
  646.          ║ DTR/DSR  RTS/CTS echo test       ║ <- Tests handshake lines
  647.          ║ Dynamic  RTS/CTS handshake test  ║+<-|Handshakes under simulated
  648.          ║ Dynamic Xon/Xoff handshake test  ║+<-|on-line conditions.
  649.          ║ Display any 10 S-registers       ║ <- Display S-registers
  650.          ║ Help and Info on these tests     ║ <- Help or ALT-H
  651.          ║       Return To Main Menu        ║
  652.          ╚══════════════════════════════════╝
  653.                                              + registered version only
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.        Modem Doctor Ver 5.0 copyright (c) 1987-1993 Hank Volpe    Users Manual                                       Page 11
  668.  
  669.  
  670.                      * Select these from Carrier menu
  671. ┌───────────────────────────── The Modem Doctor────────────────────────────┐
  672. │Log-in   Regs      Carrier   Loopback  Options   Setup     End Program    │
  673. └──────────────────────────────────────────────────────────────────────────┘
  674.                    ╔[  Setup  ]═════════════╗
  675.                    ║ Run the Carrier Tests  ║ <- Simulate on-line tests
  676.                    ║ Select Modem Commands  ║ <- Pick a modem driver
  677.                    ║ Help With Carrier Test ║ <- Help
  678.                    ║  Return to Main Menu   ║
  679.                    ╚════════════════════════╝
  680.  
  681.                                 * Select from Loopback
  682. ┌───────────────────────────── The Modem Doctor────────────────────────────┐
  683. │Log-in   Regs      Carrier   Loopback  Options   Setup     End Program    │
  684. └──────────────────────────────────────────────────────────────────────────┘
  685.                    ╔[  Loopback Tests  ]═══════════╗
  686.                    ║ Analog Loopback using a PLUG  ║ +<- test Uart & Cables
  687.                    ║ Digital Loopback 8250 UARTS   ║ +<- Uart test only
  688.                    ║ Loopback Plug Technical Data  ║ +<- How to build a
  689.                    ║ Help with Loopback Tests      ║     loopback plug
  690.                    ║     Return To Main Menu       ║
  691.                    ╚═══════════════════════════════╝
  692.                                                    +registered version only
  693.  
  694.  
  695.                                          * Select from Options
  696. ┌───────────────────────────── The Modem Doctor────────────────────────────┐
  697. │Log-in   Regs      Carrier   Loopback  Options   Setup     End Program    │
  698. └──────────────────────────────────────────────────────────────────────────┘
  699.                               ╔[  User Options Selection  ]╗
  700.  A Built-in mini-terminal  -> ║ Interactive Terminal Mode  ║
  701.  Status of all tests       -> ║ View Current Statistics    ║
  702.  Reset all tests to 0      -> ║ Reset Current Statistics   ║
  703.  Send results to printer   -> ║ Print Current Statistics   ║
  704.                               ║ Help with these options    ║
  705.                               ║    Return To Main Menu     ║
  706.                               ╚════════════════════════════╝
  707.  
  708.  
  709.                                                    * Setup selections
  710. ┌───────────────────────────── The Modem Doctor────────────────────────────┐
  711. │Log-in   Regs      Carrier   Loopback  Options   Setup     End Program    │
  712. └──────────────────────────────────────────────────────────────────────────┘
  713.                                        ╔[  Setup  ]═════════════╗
  714.  Pick the Comm port and Baud rate   -> ║ Setup Command Section  ║
  715.  Customize your choice of colors    -> ║ Choose System Colors   ║
  716.                                        ║  Return to Main Menu   ║
  717.                                        ╚════════════════════════╝
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.        Modem Doctor Ver 5.0 copyright (c) 1987-1993 Hank Volpe    Users Manual                                       Page 12
  734.  
  735.                                                             * End options
  736. ┌───────────────────────────── The Modem Doctor────────────────────────────┐
  737. │Log-in   Regs      Carrier   Loopback  Options   Setup     End Program    │
  738. └──────────────────────────────────────────────────────────────────────────┘
  739.                                                          ╔[  Exit Options]═╗
  740.                          Quit and display results     -> ║ Exit the Program║
  741.                          Don't quit, stay in program  -> ║ Don't Exit      ║
  742.                                                          ╚═════════════════╝
  743.  
  744.  
  745. If you have a mouse, you can easily construct a custom mouse driver that
  746. will replace all of your motions. The Modem Doctor does not presently
  747. contain built-in mouse support, but it will work with any program such as
  748. Microsoft's Mouse.com and Menu.com. An example driver is included with the
  749. files on disk (MDR.MNU). Basically, you use the mouse motion left to right
  750. and up and down to replace the arrow keys, a key for escape and a key for
  751. enter or return.
  752.  
  753. Test report generator:
  754.  
  755. Whenever you quit the Modem Doctor you will get a statistical summary of
  756. all the tests and results that were run. You can also access this report
  757. anytime, and print it or reset it to zero from the options menu pulldown
  758. system. The results of these tests look like this;
  759.  
  760. ----------------------------------------------------------------------------
  761. THE MODEM DOCTOR   Ver. 4.0  Copyr. 1990 by Hank Volpe has tested this modem
  762. ----------------------------------------------------------------------------
  763.  
  764.         Diagnostics were run on your modem with the following results
  765.  
  766. Results of COM2 Testing
  767.  Test Name             # of Tests      # of Char Sent    # of Errors
  768.  ---------------       ----------      --------------    -----------
  769.  CARRIER ORIGINATE         0                0                  0
  770.  CARRIER ANSWER            0                0                  0
  771.  ANALOG LOOP               0                0                  0
  772.  DIGITAL LOOP              0                0                  0
  773.  MICROPROCESSOR            0               n/a                 0
  774.  REGISTER TESTS           24               n/a                 2
  775.  INTERRUPT TESTS           1               n/a                 0
  776.  
  777.                        Speeds Modem/Uart were tested at
  778.                        --------------------------------
  779.  
  780. Tested Baud Rate : 2400
  781.  
  782.  
  783.  
  784. Results will be displayed in order for each comm port you tested. If there
  785. was an error detected, this line will be highlighted on the screen. You can
  786. reset these tests at any time, print and reset, or whatever you like.
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.        Modem Doctor Ver 5.0 copyright (c) 1987-1993 Hank Volpe    Users Manual                                       Page 13
  800.  
  801.  
  802.  
  803. The Status Bar
  804. ---------------
  805.  
  806.         Com1 | 2400bps | Micro:ON | TxINT: ON | Cfg: Generic Compatible
  807.  
  808.  
  809.  
  810. The status bar is displayed at the bottom of the screen. It shows you
  811. The Port you are using and the speed your port is operating at.
  812. Additionally it shows you if the Modem Doctor has successfully communicated
  813. to the modem microprocessor. MICRO : ON means it has, MICRO : OFF means
  814. that it has not. Normally, if you run the Modem / Uart test from
  815. the setup mode, this display will say MICRO : ON. If you only ran the Uart
  816. test, then it will say MICRO : OFF. You can toggle between states using a
  817. short-cut Hot-Key ALT-F, but I wouldn't recommend it your first time out.
  818. The ALT-F really can help if you have a modem problem to force testing,
  819. which is why it was included as a feature. See the technical reference
  820. manual for a detailed description of this feature. 
  821.  
  822. TxINT :ON indicates that Modem Doctor is using "transmit interrupts" to 
  823. determine when to send characters to your uart. ALT-T toggles this feature on 
  824. or off. Older 8250 Uarts running on slow systems had serious problems using 
  825. transmit interrupts. If you have such a machine, I would recommend you turn 
  826. this feature off if you have any problems. Refer to the Technical Reference 
  827. Manual for further information. Finally, the name of the Modem Driver you are 
  828. currently using is displayed on the right. 
  829.  
  830.  
  831. Alert Bars:
  832. -----------
  833.  
  834. Alert bars are warnings that the Modem Doctor found something that it thinks
  835. should be set another way to insure good communications. The warning is
  836. displayed with a red bar and a "beep". That is called a fatal error, which
  837. means that it is doubtful that your modem or serial port will operate with
  838. these settings. Other alert bar displays that do not have a audible "beep"
  839. are considered setup warnings, and are suggestions of what you should do to
  840. make your communications better.
  841.  
  842. External Modem Drivers (MDR5.DRV)
  843.  
  844. The Modem Doctor uses a software module to communicate with most brands of
  845. modems. These "modem drivers" are built into the Modem Doctor. When you
  846. start up the Modem Doctor, it will make a choice of the correct
  847. driver to use depending on what kind of modem it finds. You can always
  848. override this choice by going to the Carrier tests and selecting the
  849. pulldown "Select Modem Commands".
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.        Modem Doctor Ver 5.0 copyright (c) 1987-1993 Hank Volpe    Users Manual                                       Page 14
  866.  
  867.  
  868. To keep your registered version of Modem Doctor as state-of-the-art as
  869. possible, Version 4.0 and higher have the ability to read external modem
  870. driver files. Like printer drivers, these files can be loaded to extend the
  871. ability of the Modem Doctor to communicate with any type of modem. This
  872. means you should never need to update for the sake of incorporating a new
  873. modem selection into the Modem Doctor. ALL FUTURE MODEM DRIVER FILES WILL BE
  874. DISTRIBUTED FREE OF CHARGE. You can always download the latest version of 
  875. Modem Doctor and Modem Drivers from the Modem Doctor BBS (410-256-3631).
  876.  
  877. Questions about the Modem Doctor
  878. --------------------------------
  879.  
  880. Q: Will the Modem Doctor "fix" a problem?
  881. A: If the problem is software based, or if it is a problem with port
  882.    conflicts or incorrect assignments, the Modem Doctor will straightened it
  883.    out for testing purposes only. It will advise you though what it found
  884.    and suggest what you can do to correct the problem later. You can always
  885.    print this information by using the Print Screen command from your
  886.    keyboard.
  887.  
  888.  
  889.  
  890. Q: I have a LCD display, and the colors the modem doctor uses do not give
  891.    me good contrast.
  892.  
  893. A: Go to setup, select custom colors, and pick the shades you like, or
  894.    better still, use monochrome shades. This information will be saved
  895.    in a file in the same directory you are in currently for the next time
  896.    you load the Modem Doctor.
  897.  
  898.  
  899. Q: I tell the Modem Doctor to test my Modem, but it says it is not
  900.    compatible.
  901.  
  902. A: This could be due to several things;
  903.     1) You must make sure you use a baud rate equal to or lower than
  904.        the maximum baud rate of your modem. If you try for example to talk
  905.        to the modem at 19.2K bps but your modem is only a 2400 bps, then
  906.        the Modem Doctor will report falsely about your modem.
  907.  
  908.     2) You do not have a modem attached to that port. In this case run the
  909.        Uart diagnostics.
  910.  
  911.     3) Your modem is off or disconnected.
  912.  
  913.  
  914.  
  915. Q: I would like to use a mouse, but the Modem Doctor doesn't recognize it.
  916. A: The Modem Doctor does not have internal mouse support, but it will work
  917.    with programs such as Microsoft's Menu.com and special mouse drivers
  918.    that you create. A sample driver is included with the Modem Doctor.
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.        Modem Doctor Ver 5.0 copyright (c) 1987-1993 Hank Volpe    Users Manual                                       Page 15
  932.  
  933.  
  934. Q: If a new modem comes on the market that is not compatible, can the Modem
  935.    Doctor work with it?
  936.  
  937. A: You can use the Modem Doctor in what is called the "Dumb Modem" mode to
  938.    test any modem than has external switches to generate carrier tests.
  939.    Furthermore, this release of the Modem Doctor will work with externally
  940.    created modules for incompatible modems. If a modem is manufactured at
  941.    a later time that creates a new set of rules, these external modules
  942.    will be distributed at no cost to all users. Also, custom modules can be
  943.    created for any registered user for a small fee.
  944.  
  945.  
  946. Q: The Analog loop tests do not run.
  947. A: This feature only works in the registered version. If you have a     
  948.    registered version and have a problem, you also need to have a loop-back  
  949.    plug attached either to the back of your PC, or to the end of a cable     
  950.    that you are testing. You can run these tests usually through most modem
  951.    command modes, however you might get errors that are not valid. The    
  952.    Analog loopback was meant to be a help in spotting a bad cable or
  953.    connector.
  954.  
  955. Q: Do I need to worry if my modem does not pass any of the Dynamic tests?
  956. A: Only if you have a high speed modem. Most 9600 bps modems need these
  957.    handshaking signals to work properly, but at 2400 and lower, they are
  958.    seldom used. If the Modem Doctor reports that all the uart handshaking
  959.    signals are present, then all you need to do is set your modem up
  960.    according to the manufacturers handbook. You can do this from the
  961.    Interactive terminal mode without even exiting the Modem Doctor, and then
  962.    use the Modem Doctor to test that your settings are correct.
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.